home *** CD-ROM | disk | FTP | other *** search
/ Enter 2005 August / EnterCD 08_2005.iso / dosapps / freedos / doc / atapicdd / atapicdd.txt
Encoding:
Text File  |  2003-07-14  |  5.1 KB  |  119 lines
  1. ATAPICDD - ATAPI CD Driver for DOS
  2. Written by Kenneth J. Davis <jeremyd@computer.org>, 2001-2003
  3. Released to public domain  [ U.S. Definition ]
  4.  
  5. Current version is 0.2.0 ALPHA
  6. Version # = major.minor.developement (0 for dev == released version)
  7.  
  8. ATAPI code based on public domain C code from Hale Landis' ATADRVR
  9.  
  10. Use at own risk, author assumes no liability nor responsibility
  11. for use, misuse, lack of use, or anything else as a result
  12. of this program.  No warranty or other implied nor given.
  13.  
  14. While use and distribution (even by commercial entities) is
  15. encouraged, I (KJD) will not assume any responsibility for this
  16. driver's use.  Should your local laws not permit this disclaimer,
  17. or would otherwise still allow me to be held responsible, then you
  18. may not use this driver.  Other persons or entities may provide
  19. a warranty or other if so desired and stated or implied by
  20. method of recieving this driver; I am not affiliated with them.
  21.  
  22. Please send bug reports to me so that they may hopefully be fixed.
  23. If possible please include your contact information (email address)
  24. so I may ask you further details or to verify it as fixed.
  25. Fixes will be supplied as my time permits.
  26.  
  27. USAGE:
  28. Load device driver from CONFIG.SYS (or dynamic device loader such as DEVLOAD)
  29. device=[drive][path]ATAPICDD.SYS <options>
  30.  
  31. device=        standard method of loading a device in CONFIG.SYS
  32. [drive][path]  drive and/or path to device driver file
  33. ATAPICDD.SYS   the driver itself, if renamed use appropriate filename
  34. <options>      supported command line options, /D, /N, /K, and /C
  35.   Options are processed left to right, with rightmost one overriding any before it
  36.   invalid options will be silently ignored (and may screw up rest of processing)
  37.   Only /D and /N are specified by CDEX document, the remaining are extensions
  38.   and subject to change in future revisions (to avoid conflicts with existing practice)
  39.   /D:<name>
  40.     - will set the device name field (DOS device) to <name>
  41.     - default is 'FDCD0000'
  42.     - if <name> is less than 8 characters then space ' ' padded on right to 8 bytes
  43.     - if <name> is more than 8 characters, the rest are ignored
  44.   /N:#
  45.     - specifies to look for # devices
  46.     - default is 1 (as per spec)
  47.     - maximum value is 8 (up to MAX_CONTROLLERS*2 are supported), higher values are ok
  48.     - a value of 0 indicates search for maximum devices
  49.     - # is a single HEX digit, remaining characters are ignored
  50.   /K:#
  51.     - specifies to ignore controller #
  52.     - # is the index into the controller table, which normally refers to IDE 0,1,2,3
  53.     - # is a single HEX digit, remaining characters are ignored
  54.     - if # refers to a value < 0 or >= MAX_CONTROLLERS it is ignored
  55.   /C:#,<baseIO>   [ TODO ]
  56.     - overrides default value of base I/O address of controller #
  57.     - # see /K for description of # (controller index)
  58.     - , is required separator, as future revisions may expand # to larger than nibble
  59.     - <baseIO> is HEX base I/O port address, e.g. 1F0
  60.     - Default locations to look for ATA/ATAPI devices:
  61.         controller(#)    baseI/Oaddress
  62.         primary   (0)    0x1F0
  63.         secondary (1)    0x170
  64.         tertiary  (2)    0x1E8
  65.         quaternary(3)    0x168
  66.   /I   [ reserved for future change interrupt # ]
  67.  
  68.  
  69. EXAMPLES:
  70. Load driver with all default values, look on all 4 standard controller locations
  71. for devices, stop search after finding 1 device, and use device name of FDCD0000
  72. device=ATAPICDD.SYS
  73.  
  74. Load driver but only check 2 primary controller locations
  75. device=ATAPICDD.SYS /K:2 /K:3
  76.  
  77. Load driver specifying device name of ATAPICDD and search for all
  78. available (and supported) devices
  79. device=ATAPICDD.SYS /D:ATAPICDD /N:0
  80.  
  81. Load driver looking for 2 devices, but one of the devices is on the
  82. primary controller and the other is on a secondary controller with a different
  83. base I/O port address of 0xABC (note: we can use 1,2,or 3 as # to /C
  84. since there is no device on any of them, but using 1 prevents unnecessary searching)
  85. device=ATAPICDD.SYS /C:1,ABC /N:2
  86.  
  87. Load driver but search on secondary controller before primary
  88. device=ATAPICDD.SYS /C:0,170 /C:1,1F0
  89.  
  90. Load driver with options that result in default behaviour, notice how rightmost
  91. option overrides earlier one
  92. device=ATAPICDD.SYS /C:0,170 /C:0,1F0
  93.  
  94. Load driver, explicitly setting same options as default
  95. device=ATAPICDD.SYS /D:FDCD0000 /N:1 /C:0,1F0 /C:1,170 /C2:1E8 /C3:168
  96.  
  97.  
  98. NOTES:
  99. This is an early release, not intended for public distribution.
  100. It may contain debug or experimental code.  Note the link specified
  101. below is intended to be the permanent home (i.e. where you can
  102. link and tell others to find it).
  103.  
  104. Requires at least a 80186, though only tested on a 486 and higher.
  105. Presently only works in PIO mode, though future work will add
  106. DMA modes.  Also only implements minimal functions necessary for
  107. data transfers.  Future releases will add audio play/stop support.
  108. Should support up to 8 drives, but primarily tested with only
  109. 1 CD-ROM drive and occasionally on a system with 2 CD-ROM drives.
  110. Personally works for me on a 486/CD-ROM, 586/DVD-ROM, and a
  111. PentiumII/DVD-ROM system.
  112.  
  113.  
  114. Latest version of driver may be found at:
  115. http://www.darklogic.org/fdos/projects/atapicdd/
  116.  
  117. This document also public domain.
  118. 20030621
  119.